---
title: 快速开始
description: 5分钟快速开始使用内存管理
---

只需几分钟即可开始使用LangCrew内存管理。本指南涵盖基本设置和常见使用模式。

## 安装

安装带有内存管理支持的LangCrew：

```bash
# 安装LangCrew
uv add langcrew
```

## 基本用法

### 1. 简单内存设置

```python
from langcrew import Agent, Crew

# 创建内存配置 - 直接启用即可！
memory_config = True  # 使用默认设置，启用所有内存类型

# 创建带有内存的代理
agent = Agent(
    role="内存助手",
    goal="记住并使用我们对话中的信息",
    backstory="您是一个具有出色记忆能力的AI助手"
)

# 创建带有共享内存的团队
crew = Crew(
    agents=[agent],
    memory=memory_config
)
```

### 2. 运行您的第一个启用内存的对话

```python
# 第一次对话
result1 = crew.kickoff(
    inputs={"user_input": "我叫Alice，喜欢吃披萨"}
    thread_id="conversation_1"
)

# 稍后的对话 - 代理记住Alice
result2 = crew.kickoff(
    inputs={"user_input": "我喜欢什么食物？"}
    thread_id="conversation_1"  # 相同的thread ID
)

print(result2)  # 代理会记住Alice喜欢披萨
```

### 3. 使用SQLite的持久内存

```python
from langcrew.memory import MemoryConfig

# 持久内存配置
memory_config = MemoryConfig(
    provider="sqlite",
    connection_string="sqlite:///my_memory.db",
    short_term={"enabled": True}
    long_term={"enabled": True}
)

crew = Crew(agents=[agent], memory=memory_config)

# 内存在程序重启后保持
result = crew.kickoff(
    inputs={"user_input": "记住我在TechCorp工作"}
    thread_id="user_alice"
)
```

## 内存类型实战

### 短期记忆

记住会话中的近期对话历史：

```python
# 配置短期记忆
memory_config = MemoryConfig(
    short_term={
        "enabled": True,
         # 保留最后15轮对话
    }
)

# 代理将记住近期消息的上下文
crew = Crew(agents=[agent], memory=memory_config)
```

### 长期记忆

跨会话存储重要知识：

```python
# 配置长期记忆
memory_config = MemoryConfig(
    long_term={
        "enabled": True,
         # 仅存储高质量信息
    }
)

# 代理学习并记住重要事实
crew = Crew(agents=[agent], memory=memory_config)
```


## 内存搜索

搜索所有内存类型：

```python
# 搜索内存
results = crew.search_memory(
    query="Alice",
    memory_type="all",  # 搜索所有内存类型
    limit=5
)

for result in results:
    print(f"内存类型: {result['memory_type']}")
    print(f"内容: {result['content']}")
```

## 配置示例

### 开发设置（内存模式）

```python
memory_config = MemoryConfig(
    provider="memory",  # 快速，无持久化
    short_term={"enabled": True}
    long_term={"enabled": True}
)
```

### 生产设置（PostgreSQL）

```python
memory_config = MemoryConfig(
    provider="postgresql",
    connection_string="postgresql://user:pass@localhost:5432/memory_db",
    short_term={"enabled": True}
    long_term={"enabled": True}
)
```

### 本地开发（SQLite）

```python
memory_config = MemoryConfig(
    provider="sqlite",
    connection_string="sqlite:///development.db",
    short_term={"enabled": True}
    long_term={"enabled": True}
)
```

## 常见模式

### 客户服务代理

```python
# 启用内存的客户服务
memory_config = MemoryConfig(
    provider="sqlite",
    connection_string="sqlite:///customer_service.db",
    short_term={"enabled": True}
)

service_agent = Agent(
    role="客户服务代表",
    goal="提供个性化的客户支持",
    backstory="您记住客户历史和偏好"
)

crew = Crew(agents=[service_agent], memory=memory_config)

# 每个客户有自己的线程
result = crew.kickoff(
    inputs={"user_input": "我需要帮助处理我的订单"}
    thread_id=f"customer_{customer_id}"
)
```

### 学习助手

```python
# 启用内存的学习助手
memory_config = MemoryConfig(
    provider="sqlite",
    connection_string="sqlite:///learning.db",
    long_term={"enabled": True},  # 存储学习内容
)

tutor = Agent(
    role="个人导师",
    goal="根据学生进度调整教学",
    backstory="您记住学生学过什么以及他们的困难"
)

crew = Crew(agents=[tutor], memory=memory_config)
```

## 下一步

- **[短期记忆](/zh/guides/memory/short-term)** - 深入了解对话历史
- **[长期记忆](/zh/guides/memory/long-term)** - 持久知识存储
- **[存储配置](/zh/guides/memory/storage)** - 配置不同的存储后端

## 故障排除

### 内存不持久

- 检查您的`connection_string`格式
- 确保数据库权限正确
- 验证数据库文件/连接可访问

### 内存使用量高

- 使用数据库提供商的连接池
- 考虑使用SQLite/PostgreSQL而不是内存模式

### 性能慢

- 生产工作负载使用PostgreSQL
- 为数据库提供商启用连接池
- 开发/测试考虑内存提供商
